Skip to content

chore(deps): pin agentex-sdk[adk] for ADK surface access#251

Closed
max-parke-scale wants to merge 1 commit into
mainfrom
maxparke/agx1-292-pin-agentex-sdk-adk
Closed

chore(deps): pin agentex-sdk[adk] for ADK surface access#251
max-parke-scale wants to merge 1 commit into
mainfrom
maxparke/agx1-292-pin-agentex-sdk-adk

Conversation

@max-parke-scale
Copy link
Copy Markdown

@max-parke-scale max-parke-scale commented May 26, 2026

Summary

Migrates this repo's agentex-sdk pins to agentex-sdk[adk] ahead of the planned dep split in scaleapi/scale-agentex-python#368 (AGX1-292).

After the split lands, bare pip install agentex-sdk will only install the Stainless REST client (6 deps). The agentex.lib.* ADK surface — CLI, ACP server, Temporal, LLM provider integrations, observability — will require agentex-sdk[adk].

This repo uses agentex.lib.* for:

  • mkdocstrings autodoc generation (agentex/pyproject.toml docs group)
  • Local development tooling (dev group)
  • Workspace consumer (pyproject.toml)

Rollout safety

This PR is safe to land at any time, independent of scaleapi/scale-agentex-python#368's status:

Files

File Pins changed
pyproject.toml 1 (workspace dep)
agentex/pyproject.toml 3 (dev group + docs group ×2)

The # Override agentex-sdk's fastapi<0.116 pin ... comment is intentionally unchanged.

Test plan

  • CI passes.
  • Docs build (mkdocs build) still works.
  • Dev environment still installs cleanly.

The agentex-sdk package is splitting heavy ADK/server-side deps into an
optional [adk] extra (scaleapi/scale-agentex-python#368). This repo
imports from `agentex.lib.*` for docs generation (mkdocstrings) and
local development, so the workspace and backend service pyproject pins
need the [adk] extra to keep working.

Safe to land at any time:
- Against current published agentex-sdk: pip warns "extra 'adk' not
  found" but installs successfully — same install behavior as today.
- After scale-agentex-python#368 lands: clean install via the new extra.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@max-parke-scale
Copy link
Copy Markdown
Author

Closing in favor of a non-breaking redesign: publish a new lean sibling package agentex-sdk-client containing only the Stainless REST client surface (agentex/{__init__.py, _*.py, types/, resources/}) with 6 base deps. agentex-sdk keeps shipping agentex/lib/* and adds agentex-sdk-client as a runtime dep — existing consumers (pip install agentex-sdk) see no change. Only REST-only consumers like packages/egp-api-backend (currently hand-rolling clients to avoid dep weight) need to migrate.

This avoids the breaking-change blast radius (130+ files across 5 repos) that this PR would have required.

Tracking: AGX1-292. PR scaleapi/scale-agentex-python#367 (drop dead deps + exclude tests from wheel) stays open as a no-breaking-change cleanup.

🤖 — posted via Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant